FRAMESETNN n/a   IE 4   DOM 1

The FRAMESET object reflects the FRAMESET element. While Navigator knows about framesets as objects, it treats a frameset like any other window object. Internet Explorer 3 and later also observe this behavior. Therefore, for cross-platform access to FRAMESET properties and methods, see the window object listing in this chapter. But if you need access to the properties listed in this section, you must access the FRAMESET object via its frameset ID. Be aware that references to frameset objects shown in this section may not work properly in the Windows 95 version of Internet Explorer 4. Also, the windowRef placeholder may be filled with parent or top if the reference is in a script contained by a child frame.

 
HTML Equivalent
<FRAMESET>
 
Object Model Reference
IE [windowRef.]document.all.framesetID
borderNN n/a   IE 4   DOM n/a
 Read/Write
 

Thickness of the spaces between frames in a frameset in pixels. Only the outermost FRAMESET element of a system of nested framesets responds to the border property setting. Internet Explorer 4 treats the default thicknesses for Windows and Macintosh differently, so be aware that the same value may look different on each operating system platform.

 
Example
top.document.all.myFrameset.border = 4
 
Value
An integer value. A setting of zero eliminates the border entirely. While the value is supposed to represent the precise pixel thickness of borders in the frameset, this is not entirely true for all operating systems or browsers.
 
Default 6 (IE 4 Windows); 1 (IE 4 Mac).
borderColorNN n/a   IE 4   DOM n/a
 Read/Write
 

Color of borders between frames of the frameset. The borderColor property of an individual frame overrides the FRAMESET object's setting

 
Example
parent.document.all.myFrameset.borderColor = "salmon"
 
Value
A hexadecimal triplet or plain-language color name. A setting of empty is interpreted as "#000000" (black).
 
Default Varies with operating system.
colsNN n/a   IE 4   DOM 1
 Read/Write
 

Defines the sizes or proportions of the column arrangement of frames in a frameset. Column size is defined in one of three ways:

An absolute pixel size

A percentage of the width available for the entire frameset

A wildcard (*) to represent all available remaining space after other pixels and percentages have been accounted for

Exercise extreme care when scripting a change to this property. Altering the composition of a frameset on the fly might disrupt scripts that communicate across frames. Reducing the number of columns may destroy documents whose scripts or objects support scripts in other frames or the parent. It is safest to maintain the same number of columns, but use this property to adjust the widths of existing frame columns.

 
Example
parent.document.all.framesetter.cols = "40%,60%"
 
Value
Comma-separated list (as a string) of pixel, percentage, or wildcard (*) values. Internet Explorer 4 for the Macintosh exhibits incorrect behavior with some combinations that include a wildcard value.
 
Default 100%
frameBorderNN n/a   IE 4   DOM n/a
 Read/Write
 

Controls whether the frameset displays borders between frames. Adjusting this property does not dynamically change the border visibility in Internet Explorer 4.

 
Example
parent.document.all.framesetter.frameBorder = "no"
 
Value
Internet Explorer 4 accepts the string values of 1 (on) and 0 (off) as well as yes and no.
 
Default yes
frameSpacingNN n/a   IE 4   DOM n/a
 Read/Write
 

The amount of spacing in pixels between frames within a frameset.

 
Example
parent.document.all.framesetter.frameSpacing = 5
 
Value
Integer.
 
Default 2
rowsNN n/a   IE 4   DOM 1
 Read/Write
 

The sizes or proportions of the row arrangement of frames in a frameset. See the cols property for additional details of selecting values for the rows property.

 
Example
document.all.myFrameset.rows = "20%, 300, *"
 
Value
String of comma-delimited list of pixel or percentage values, or the * wildcard character.
 
Default None.